package com.cys.markdown.doc.project.interfaces.service;

import com.cys.markdown.doc.project.interfaces.entity.IProjectDoc;
import com.github.pagehelper.PageInfo;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;
import java.util.Map;

/**
 * T_PROJECT_DOC【项目文档表】 Service接口
 *
 * @author caiyushen
 */
@Transactional
public interface ProjectDocService {

    /**
     * 新增ProjectDoc
     *
     * @param params ProjectDoc实体类对应参数
     * @return ProjectDoc实体类
     */
    IProjectDoc save(Map<String, Object> params) throws Exception;

    /**
     * 新增ProjectDoc
     *
     * @param projectDoc ProjectDoc实体类
     * @return ProjectDoc实体类
     */
    IProjectDoc save(IProjectDoc projectDoc);

    /**
     * 修改ProjectDoc
     *
     * @param params ProjectDoc实体类对应参数
     * @return ProjectDoc实体类
     */
    IProjectDoc update(Map<String, Object> params) throws Exception;

    /**
     * 修改ProjectDoc
     *
     * @param projectDoc ProjectDoc实体类
     */
    IProjectDoc update(IProjectDoc projectDoc);

    /**
     * 通过id物理删除ProjectDoc
     *
     * @param id ProjectDoc主键
     */
    void deleteById(Long id);

    /**
     * 批量物理删除ProjectDoc
     *
     * @param ids ProjectDoc主键数组
     */
    void deleteBatch(Long[] ids);

    /**
     * 通过id逻辑删除ProjectDoc
     *
     * @param id ProjectDoc主键
     */
    void logicDeleteById(Long id);

    /**
     * 批量逻辑删除ProjectDoc
     *
     * @param ids ProjectDoc主键数组
     */
    void logicDeleteBatch(Long[] ids);

    /**
     * 根据id加载ProjectDoc
     *
     * @param id ProjectDoc主键
     * @return ProjectDoc实体类
     */
    IProjectDoc find(Long id);

    /**
     * 根据id以及登录用户id加载ProjectDoc
     *
     * @param id        ProjectDoc主键
     * @param sysUserId 用户主键
     * @return ProjectDoc实体类
     */
    IProjectDoc findBySysUserId(Long id, Long sysUserId);

    /**
     * 获取ProjectDoc列表数据
     *
     * @param map 默认空数据集
     * @return 数据列表
     */
    List<IProjectDoc> findList(Map<String, Object> map);

    /**
     * 分页获取数据
     *
     * @param pageNo   当前页
     * @param pageSize 当前页数
     * @param params   检索参数
     * @return 分页数据
     */
    PageInfo<IProjectDoc> findPage(Integer pageNo, Integer pageSize, Map<String, Object> params);


    /**
     * 根据用户主键、项目主键获取分页列表
     *
     * @param pageNo                当前页
     * @param pageSize              当前页数
     * @param param-projectInfoId   项目主键
     * @param param-sysUserId       用户主键
     * @param param-projectDocName 文档名称
     * @return 分页数据
     */
    PageInfo<IProjectDoc> findPageBySysUserId(Integer pageNo, Integer pageSize, Map param);

}
 



